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SUMMARY 


The HULL computer program has been used extensively to study problems in 
nuclear weapons effects and in armor penetration. In addition to the equations 
of hydrodynamics, HULL models elastic-plastic phenomenology as well as non- 
equilibrium radiation diffusion. When originally written, HULL was designed for 
the CDC 6600. With the introduction of the CDC 7600 and Cyber 176, the program 
was modified to execute on these newer machines. The increasing popularity of 
the program has required conversion to IBM system 370 compatible equipment. The 
360/370 architecture is perhaps the most widely used in the world. It is widely 
emulated in the United States and within the Soviet Bloc. Most noteworthy are 
| 


the Amdahl 470/V7, the Itel AS6, and the IBM 3033. 


This report describes the. procedures for installing HULL on 370 compatible 
equipment running the OS/VS2 operating system. The reader begins with the 
standard HULL distribution tape and installs SAIL, the SAIL library, the HULL 
library and the HULL program. The operation of HULL is described in some detail 
’ so that a user with the aid of three companion technical reports can successfully 


Set up and run problems of interest. 


Because HULL is a very large program or, more properly, a set of programs, 
not all options could be checked in detail. The user is expected to write the 


plot package interface routines that are required by HULL. In addition, certain 
| calculations may be sensitive to the default precision used by 370 compatible 
| computers. We have found that only the equation-of-state needed to be converted 


to Double Precision. However, not all EOS materials have been converted. Al] 
users are expected to exercise professional caution in exploiting the HULL pro- 
gram for problems of interest. In addition, because of the complexity of HULL, 
minor changes to the operating system can have very drastic effects on program 
operation. All users are expected to have more than rudimentary sophistication 
- in dealing with the operating system. 
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PREFACE 


This manual was prepared as a part of the joint Air Force Armament Laboratory 
(AFATL) and Air Force Weapons Laboratory (AFWL) HULL computer program effort # 
under Project 8809, Task 18, “Advanced Computer Simulation of Nuclear and Non- 
conventional Weapons and Weapons Effects." 


This report applies to the elastic-plastic HULL system as written in-house 
at the AFATL by Major Daniel A. Matuska and Major Richard E. Durrett. Al] 
references in this report to HULL relate to this computer program. 


It is a pleasure to acknowledge the assistance of Major Matuska whose techni- 
cal contributions and advice made this report possible. We are thankful to 
Captain J. 0. Skelton of the Air Force Armament Development and Test Center 
for arranging and providing funds for computer time at the Air Force Weapons 
Laboratory and at the Harry Diamond Laboratories. All calculations described in 
this report were performed at these laboratories. . 


This report is not intended to be read alone. Users of this report must be 
familiar with the contents of the following three reports: 


1. The HULL Code: A Finite Difference Solution to the Equations of 


Continuum Mechanics, AFATL-TR-78-125 by Richard E. Durrett and Daniel A. Matuska, 


Air Force Armament Laboratory, Eglin AFB, FL. 


2. SAIL, An Automated Approach to Software Development and Management, 
AFWL-TR-78-80 by Lewis P. Gaby, David H. Graham, and Clifford E. Rhoades, Jr., 


Air Force Weapons Laboratory. Kirtland AFB, NM. 


3. HULL System Report, AFWL-TR-78-115 by Lewis P. Gaby, Air Force 
Weapons Laboratory, Kirtland AFB, NM. 


Reference to a company or product name does not imply approval or recommenda- 
tion of the product by the US Government to the exclusion of others that may be 
suitable. z 
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SECTION I 
INTRODUCTION 


The study of the phenomenology of nuclear, nonconventional and conventional 
weapons effects requires an understanding of radiation hydrodynamics and elastic- 
plastic solid media response. The HULL computer program was written to provide 
these calculations. 


The HULL computer program is a complete system for operating, updating, 
running, and plotting a variety of hydrodynamic or finite difference computer 
programs. The system includes an update routine which maintains and modifies 
the system source images, tape library routines, an executive routine which 
generates the source images for the executable code, and a module for plotting 
the resulting data calculated. Development of HULL began at the Air Force Weapons 

- Laboratory in 1971. HULL was used mainly to investigate nuclear driven blast 
phenomenology. In 1975, a new phase of HULL development began at the Air Force 
Armament Laboratory. The code was extended into the elastic-plastic area with 
emphasis on solid media response. The HULL computer program is now operational 
on more than a half dozen computers in the United States and in the United Kingdom. 


This manual provides the information necessary to install and to operate HULL 
on System 370 compatible computers. Section II, HULL System Installation, con- 
tains the details of the installation. Section III, IV and V display the test 
problems which can be used to check out the installation. Except for minor 
editorial changes to conserve space, the output is presented exactly as produced 
by the computer. Appendix A summarizes the intent of this research while 
Appendix B provides a quick overview of what was learned during the process of 
moving HULL to the System 370. The preface cites two reports, which must be 
understood in detail. The bibliography contains references to other calculations 
F which may be of interest to the reader. 
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SECTION II 
HULL SYSTEM INSTALLATION 


OVERVIEW 


The HULL installation tape for the IBM system is an unlabeled nine-track 
EBCDIC tape written at 800 bpi. It contains six files that have a fixed blocked 
format (RECFM = FB). The first four have a record length of 80 (LRECL = 80) and 
a blocking factor of 10 (BLKSIZE = 800), while the two last files have a record 
length of 120 with block sizes of 1200. 


The installation of HULL on a new IBM system requires seven steps: 
(1) generation of SAIL and creation of the SAIL library, (2) obtaining the HULL/ 
SAIL execution procedures, (3) converting the SAIL file of SAIL to packed format, 
(4) converting the SAIL file of HULL to packed format, (5) generating the SAIL 
utility routine in the SAIL/HULL library, (6) generating the HULL utility routines 
in the SAIL/HULL library, and (7) generating PLANK in the SAIL/HULL library. 


SAIL GENERATION 


The source for the SAIL generation is contained on the first three files of 
the tape. The first file is the FORTRAN source, the second contains the assembly 
source and the third contains the linkage editorial directives. The initial 
generation of SAIL is the SAIL/HULL library and is accomplished by the standard 
assembly compilation procedure. ASMC and the FORTRAN H compiler and link edit 
procedure FORTHCL. The JCL to generate the SAIL/HULL library named SAIL.HULLIB 
is shown in table 1. 


EXTRACTING EXECUTION PROCEDURES 


The fourth file on the tape contains the procedures SAIL, SGEN, SLIB, HLIB, 
PGEN, KEEL, HULL, and PULL. Procedures SAIL and SGEN are described in the SAIL 
users manual while the remaining procedures are described in the HULL system 
users guide. They may be punched to cards using the IBM utility IEBGENER as 
shown in table 2. The procedure may be used in line and may be placed in the 
procedure library. 
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Table 1 
SAIL GENERATION 
//** JOB... 


//ASM EXEC ASMC 
//ASM.SYSIN DD  UNIT= TAPE9,VOL=SER=HULL ,LABEL=(2,NL), 


// DISP=(OLD,PASS), 

// DCB=RECFM=FB ,LRECL=80,BLKSIZE=800) 
//COMP EXEC FORTHCL , PARM. FORT='NAME=SAIL', 

// PARM.LKED='OVLY' 


//FORT.SYSIN DD  UNIT=TAPE9,VOL=SER=HULL ,LABEL=(1,NC), 
// DISP=(OLD,PASS), 
//0CB=(RECFM=FB ,LRECL=80,BLKSIZE=800) 

. //LKEO.SYSLMOD ODD ODSC=SAIL.HULLIB,DISP=(NEW,CATLG), 
if SPACE=(CYL,(10,10,10)UNIT=SYSDA 
//LKED.SYSIN DD UNIT=TAPE9,VOL=SER=HULL ,LABEL=3,NL), 


DISP=(OLD,KEEP), 
DCB=(RECFM=FB,LRECL=80,BLKSIZE=800) 


}¢ Table 2 
PUNCHING PROCEDURE DECKS 
[f** BH... 
//COPY EXEC PGM=IEBGENER 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD DUMMY 
p //SYSUT1 DD UNIT=TAPE9,VOL=SER=HULL ,LABEL=(4,NL) 


// DISP=(OLD,KEEP), 
// DCB=(RECFM=FB,LRECL=80, BLKSIZE=800) 
: //SYSUT2 DD  SYSOUT=B 
qd § 
a 
é 
tenn cas ——— 


= nr 
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CONVERTING SAIL 


The fifth file contains the coded format of the SAIL library of SAIL. To be 
used it must be converted to a binary packed format using the procedure SAIL as 
shown in table 3. 


CONVERTING HULL 


The sixth file is the coded format of the HULL file which also must be con- 
verted using the procedure SAIL as shown in table 4. 


GENERATING SAIL LIBRARY ROUTINE 


The utility routines from SAIL must be added to the SAIL/HULL library using 
the procedure SLIB. Table 5 shows the JCL which will add the routines to a 
library on a data set SAIL.HULLIB. 


GENERATING HULL LIBRARY ROUTINES 


The utility routines from HULL must be added to the SAIL/HULL library using 
the procedure HLIB. The JCL which adds the routines to the library on data set 
SAIL.HULLIB is shown in table 6. 


GENERATING PLANK 


Finally the program PLANK must be generated and added to the SAIL/HULL 
library. Table 7 shows an example JCL using PGEN to generate PLANK on a library 
SAIL.HULLIB. 


Table 3 


CONVERTING SAIL 
LEf™ JOB. « 


//COPY EXEC SAIL,GEND=,FILO=5,LABO=NL, 
OLDVOL=HULL ,OLDDS='(OLD,KEEP', 
OLDDCB=' (RECFM=FB,LRECL=120,BLKSIZE=1200) ', 
GENN=' .V58' ,NEWDUM= ,NEWU=SYSDA ,NEW=SAIL 
//SAIL. INPUT DD 
SAIL CONVERT COPY 


Note: Library is SAIL.HULLIB and SAIL library of SAIL is on SAIL.SAIL.V58 
stored on a system direct access device (SYSDA). 


RUM ORLA Ores 
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Table 4 
CONVERTING HULL 


Efte® SOB... 

//COPY EXEC SAIL,LENO=,FILO=6, LABO=NL, 
OLDVOL=HULL ,OLDDS='(OLD,KEEP)', 
OLDDLB=' (RELFM=FB ,LRECL=120,BLKSIZE=1200)', 
GENN='.V105' ,NEWDUM= ,NEWJ=SYSDA,NEW=HULL 

//SAIL. INPUT DD* 

SAIL CONVERT COPY 
/* 


Note: Library is on SAIL.HULLIB.SAIL library of HULL is on system 
direct access device SYSDA) as SAIL.HULL.V105. 


Table 5 
GENERATING SAIL UTILITY ROUTINES 


fie WB... 
//GEN EXEC HLIB,GENO='.V58' 
//SAIL.INPUT ODD * 

SAIL PROGRAM LIB ENDPROGRAM 
/* 


Note: Library to be used and update is SAIL.HULLIB and SAIL library 
file of SAIL is cataloged as SAIL.SAIL.V58. 


7 2 POIRIER OK Te ore neta 
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Table 6 
GENERATING HULL UTILITY ROUTINES . 


//*** JOB... 


aoe 


//PLANK EXEC  PGEN,GENO='.V105' 
//SAIL.INPUT DD * | 

SAIL PROGRAM PLANK 
/* 


Note: Object library is SAIL.HULLIB. SAIL library file of HULL is 
SAIL.HULL.V105. 


Table 7 
GENERATING PLANK 


LEGO® JOB... 
//GEN EXEC  HLIB,GENO='.V105' 
//SAIL.INPUT DD * 


SAIL PROGRAM LIBRARY ENDPROGRAM 
/* 


Note: Object library to be used and updated is cataloged as SAIL.HULLIB. 
SAIL system library of HULL is cataloged as SAIL.HULL.V105. — 
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SECTION III 


TEST PROBLEM 1.2 


Problem 1.2 is a small test problem with 560 zones. It is a cylindrical 
shaped copper rod impacting a thin steel plate at approximately 10,000 ft/s. 
Options selected for this problem were ATMOS=5, constant atmosphere, STRESS=1, 
elastic-plastic formulation included, FLUXER=3, volume and energy fluxes. Zone 
sizes were 0.25 cm square; 118 cycles were completed advancing the problem to 
16 us. Dumps at cycle 0, 20, 27, and 118 are presented. In this penetration 
simulation, the copper rod was kept stationary and the steel plate was moved at 
10,000 ft/s. By cycle 118, problem time 16 us the plate has moved to the top of 
the mesh. 
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PROBLEM 1.2 SYSTEM 370 KEEL RUN 
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AFWL-TR-78-134 


SECTION IV 
TEST PROBLEM 1.3 


Problem 1.3 is another small test problem consisting of 800 zones. It is a 
multimaterial problem with air, steel, and concrete. The configuration is 
basically a long narrow steel rod impinging upon a concrete slab at 25,000 ft/s. 
Stations were used for this run to test that part of the code. The entire JCL 
Output has been listed as an example. Dumps from cycles 0, 10, and 104 have been 


included. After approximately 3.5 us the steel penetrator has moved 5 cells into 
the concrete slab. 
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